<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1- transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
    <title>Syntax Highlight Help</title>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <meta name="AppleTitle" content="Syntax Highlight Help"/>
    <meta name="description" content="A Quick Look extension for previewing source files">
    <meta name="robots" content="index, anchors" /> 
    <link rel="stylesheet" type="text/css" href="../css/main.css" />
</head>
<body>
    <a name="SyntaxHighlight_INDEX"></a>
    <h1>Table of Contents</h1>
    <ul>
        <li id="Page1"><a href="#SyntaxHighlight_GENERAL">General</a></li>
        <li id="Page2"><a href="preferences.html">Settings</a></li>
        <li id="Page3"><a href="themes.html">Color schema editor</a></li>
        <li id="Page4"><a href="inquiry.html">Inquiry file</a></li>
    </ul>
    <br />

    <h1>Syntax Highlight</h1>
    <a name="SyntaxHighlight_GENERAL"></a>

    <p>This application offers a Quick Look Extension for MacOS 10.15 Catalina and later for previewing source files.
    Inside it uses <a href="http://www.andre-simon.de/doku/highlight/en/highlight.php" target="_blank">Highlight</a> to render source code with syntax highlighting.</p>
        
    <p>To use the Quick Look preview you must launch the Application at least once. In this way the Quick Look Extension will be discovered by the System and will be available in the System preferences/Extensions/Quick look.</p>
    
    <div><img src="images/extensions.png" alt="System preferences/Extensions" /></div>
    
    <p>This Application only generate the Quick Look Preview and do not provide a thumbnail service for the Finder icon. </p>
    
    <p><b>Syntax Highlight is distributed in the hope that it will be useful but WITHOUT ANY WARRANTY.</b></p>


    <h2><a name="SyntaxHighlight_UTI"></a>File format management</h2>
    <p>The Quick Look Extension uses the <a href="https://developer.apple.com/library/archive/documentation/FileManagement/Conceptual/understanding_utis/understand_utis_intro/understand_utis_intro.html" target="_blank">Uniform Type Identifier (UTI)</a> to handle the supported formats (and not simply the file name extension). 
    Inside the definition on an UTI there are the list of extensions and mime type associated with it.</p>

    <p>Some file types are directly associated to an UTI by the System. Other formats are registered by the owner application. In this way some extensions can be associated to multiple UTIs based on the applications currently installed. For this reason, this application supports many UTIs even if they are apparently redundant. </p>

    <p><i><b>MacOS 10.15 Catalina does not</b> allow to manage some file formats including (but not limited to):</i> <code>.xml</code>, <code>.plist</code>, <code>.html</code>, <code>.ts</code>, <code>.dart</code>, common images (<code>.jpg</code>, <code>.gif</code>, <code>.png</code>), …</p>
    <p>On <i><b>MacOS 11 Big Sur</b>, the system allows you to manage these previously unauthorized extensions:</i> <code>.plist</code>.

    <h2>Application settings</h2>

    <p>With the standalone application you can customize the settings.</p>
        
    <div><img src="images/settings.png" alt="Settings window" /></div>
        
    <p>You can show <i>advanced settings</i> using the relative command on the view menu.</p>
        
    <div><img src="images/settings_advanced.png" alt="Settings window with advanced settings" /></div>

    <ul>
        <li><a href="preferences.html">Settings</a></li>
        <ul>
            <li><a href="preferences.html#SyntaxHighlight_PREFERENCES">Global settings</a></li>
            <li><a href="preferences.html#SyntaxHighlight_FORMAT_PREFERENCES">Format settings</a></li>
        </ul>

        <li><a href="themes.html">Color schema editor</a></li>
        <li><a href="inquiry.html">Inquiry file</a></li>
    </ul>

    <h2>Credits</h2>
    <p>Application developed by <a href="https://github.com/sbarex" target="_blank">sbarex</a> with &hearts;.</p>
    <p>Highlight is developed by <a href="http://www.andre-simon.de/" target="_blank">Andre Simon</a>.</p>
    <p>Dos2unix is developed by <a href="https://waterlan.home.xs4all.nl/dos2unix.html" target="_blank">Erwin Waterlander</a>.</p>
    <br />
    <p>This application was inspired by <a href="https://github.com/anthonygelibert/QLColorCode" target="_blank">anthonygelibert/QLColorCode</a>.</p>
    
    <br />
</body>
</html>
